home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 626-637 / disk_627 / adoc / adoc.doc < prev    next >
Text File  |  1992-05-06  |  24KB  |  576 lines
  1.  
  2.             ADoc v7.04 - Manuel d'utilisation
  3.  
  4.  
  5.  
  6.  
  7.  
  8.     Ce manuel décrit la version 7.04 de l'utilitaire ADoc. Ce programme
  9. est placé dans le domaine public, avec autorisation de le copier  librement
  10. et de le diffuser par n'importe quel moyen, à condition que le produit soit
  11. diffusé dans son intégralité, et sans aucune modification.
  12.  
  13.     ADoc est (c)1990-1991-1992 par Denis GOUNELLE,  toute   utilisation
  14. commerciale ou    vente  de  ce  programme  (sans  autorisation  écrite)  est
  15. STRICTEMENT INTERDITE. Serge HAMMOUCHE est autorisé  à    diffuser  ADoc    aux
  16. conditions qu'il voudra.
  17.  
  18.     "PowerPacker 2.3b" est (c)1989  par  PowerPeak  et  Nico  FRANCOIS,
  19. "PowerPacker Pro 3.0b" est (c)1990 par PowerPeak et par  UGA  Software.  La
  20. bibliothèque "powerpacker.library" est (c)1990 par Nico FRANCOIS. AREXX est
  21. (c)1987 par Bill Hawes.
  22.  
  23.     Malgrès de nombreux tests, je ne peux garantir qu'ADoc ne  contient
  24. aucune erreur. VOUS UTILISEZ CE PROGRAMME A VOS RISQUES ET  PERILS.  Je  ne
  25. pourrai en  aucun  cas    être  tenu  responsable  de  tout  dommage,  direct
  26. ou indirect, résultant de l'utilisation d'ADoc.
  27.  
  28.  
  29. Sommaire :
  30. ----------
  31.  
  32.     1. Introduction
  33.     2. Principe de fonctionnement
  34.     3. Mode d'emploi
  35.        3.1 Appel depuis le CLI
  36.        3.2 Appel depuis le WorkBench
  37.        3.3 Mode d'emploi
  38.        3.4 La requête de terme
  39.     4. Concepts avancés
  40.        4.1 Utilisation de plusieurs fichiers de documentation
  41.        4.2 Association de fichiers
  42.        4.3 Génération de plusieurs index
  43.        4.4 Extension du jeux de caractères
  44.        4.5 Utilisation de la bibliothèque "powerpacker.library"
  45.        4.6 Le mode AREXX
  46.        4.7 Utilisation des fichiers AutoDoc
  47.        4.8 Le menu "Spécial"
  48.     5. Messages d'erreur
  49.  
  50.  
  51. 1.Introduction :
  52. ----------------
  53.  
  54.     ADoc est un utilitaire permettant de gérer des    documentations    sur
  55. n'importe quel sujet. Il dispose  d'une  fonction  de  recherche  d'un  mot
  56. désigné à la souris, et peut travailler sur plusieurs fichiers à  la  fois.
  57. ADoc peut également lire les fichiers AutoDoc de Commodore  ainsi  que    des
  58. fichiers compactés par "PowerPacker 2.3b" ou "PowerPacker 3.0b", et dispose
  59. d'un port compatible AREXX.
  60.  
  61.        +-------------------------------------------------------+
  62.        |              ATTENTION !!               |
  63.        |                               |
  64.        | Le format des fichiers de documentation n'est plus le |
  65.        | même que pour les versions 3.xx et 4.xx. Pour pouvoir |
  66.        | utiliser vos anciens fichiers, lisez la documentation |
  67.        | pour savoir quel est le nouveau format, modifiez les  |
  68.        | anciens fichiers (cela devrait vous prendre très peu  |
  69.        | de temps...) et re-générez les fichiers d'index.      |
  70.        +-------------------------------------------------------+
  71.  
  72.     Vous pouvez me faire part de vos remarques ou critiques  sur  ADoc,
  73. en écrivant à l'adresse suivante :
  74.  
  75.               M. GOUNELLE Denis
  76.                   Boite 71
  77.              6, rue des cailloux
  78.             92110 CLICHY - FRANCE
  79.  
  80.     Merci à Jean-Yves PROUX, Jean-Philippe RAPP, et Helmut J.  ESENWEIN
  81. pour leurs nombreuses suggestions, à Simon HEWINSON pour la  traduction  en
  82. anglais du fichier "Amiga.doc". Merci également à Jean-Philippe  RAPP  pour
  83. m'avoir permis de tester ADoc sur les fichiers AutoDoc version 2.02.
  84.  
  85.  
  86. 2. Principe de fonctionnement :
  87. -------------------------------
  88.  
  89.     ADoc travaille à partir d'un fichier  de  documentation,  que  vous
  90. créez vous-même au moyen d'un éditeur de texte.  Ce  fichier  contient  une
  91. suite de termes, chaque terme ayant la syntaxe suivante :
  92.  
  93.         terme
  94.             ligne explication 1
  95.             ligne explication 2
  96.                .    .    .
  97.                .    .    .
  98.             ligne explication n
  99.  
  100.     Il est absolument indispensable que la    première  lettre  de  terme
  101. soit sur la colonne 1, et que les lignes d'explications commencent  par  au
  102. moins un espace ou une tabulation, car c'est le seul  moyen  pour  ADoc  de
  103. distinguer un terme de son explication. De plus, les deux premières  lignes
  104. du fichier doivent absolument être vides, ou commencer par un espace ou une
  105. tabulation (voir §4.2 et §4.4).
  106.  
  107.     Un terme ne peut pas faire  plus  de  32  caractères,  et  ne  peut
  108. contenir ni espaces ni tabulations : les seuls caractères permis  sont    les
  109. lettres minuscules et majuscules, les chiffres,  les  caractères  accentués
  110. minuscules (codes ASCII entre 217 et 246) et le caractère souligné. Il  est
  111. cependant possible d'étendre le jeu de caractères autorisés (voir §4.4).
  112.     Si un même terme est défini plusieurs fois dans un fichier,  aucune
  113. erreur ne sera annoncée : ADoc se contentera  de  mettre  à  la  suite    les
  114. lignes d'explication lorsqu'il affichera le texte correspondant à ce terme.
  115. Si vous définissez un terme "AboutThisDoc", le  texte  correspondant  à  ce
  116. terme sera automatiquement affiché lors du démarrage d'ADoc.
  117.  
  118.     On ne peut mettre plus de 32767 termes    par  fichier.  La  longueur
  119. maximale des lignes d'explication est de 256 caractères (bien que  seul  le
  120. début soit affiché). Le nombre de lignes d'explication par terme n'est  pas
  121. limité.
  122.  
  123.     Les lignes  d'explication  peuvent  éventuellement  comprendre  les
  124. séquences ANSI suivantes :
  125.  
  126.             ESC[0m      caractères normaux
  127.             ESC[1m      début gras
  128.             ESC[3m      début italique
  129.             ESC[22m   fin gras
  130.             ESC[23m   fin italique
  131.  
  132.     Une fois le fichier de documentation constitué, ADoc  construit  un
  133. fichier d'index, qui  permet  d'accéder  presque  instantanément  au  terme
  134. recherché. Le mon de cet index est obtenu en ajoutant le  suffixe  ".index"
  135. au nom du fichier de documentation.
  136.  
  137.  
  138.        +-------------------------------------------------------+
  139.        |              ATTENTION !!               |
  140.        |                               |
  141.        | Vous devez reconstruire l'index à chaque modification |
  142.        | du fichier de documentation.               |
  143.        +-------------------------------------------------------+
  144.  
  145.  
  146. 3. Mode d'emploi :
  147. ------------------
  148.  
  149.     ADoc peut s'utiliser depuis le  CLI  ou  depuis  le  WorkBench.  Le
  150. fichier de documentation par défaut est "Amiga.doc" mais on peut, dans  les
  151. deux cas, indiquer un autre fichier.
  152.  
  153.  
  154.     3.1 Appel depuis le CLI
  155.     -----------------------
  156.  
  157.     Depuis le CLI, la syntaxe de l'appel est la suivante :
  158.  
  159.          ADoc  -i [-f<fichier>]
  160.           ou ADoc [-c][-e][-f<fichier>][-l][-n][-q][-A][<terme>]
  161.  
  162.     La première forme demande la création de l'index  d'un  fichier  de
  163. documentation, la seconde permet de consulter la  documentation.  Voici  la
  164. description des options :
  165.  
  166.     -i        Indique que la seule opération à faire est  la    création
  167.         de l'index. Doit OBLIGATOIREMENT être la première option
  168.         sur la ligne de commande.
  169.  
  170.     -c        Demande à ADoc de  ne  pas  différencier  minuscules  et
  171.         majuscules, aussi bien lors des recherches que    lors  de
  172.         la requête de terme.  Devrait  être  indiqué  avant  une
  173.         éventuelle option -f.
  174.  
  175.     -e        Demande à ADoc d'ouvrir son  propre  écran,  plutôt  que
  176.         d'utiliser l'écran WorkBench.  Notez  que  ADoc  ouvrira
  177.         automatiquement son propre écran si la police par défaut
  178.         de l'écran WorkBench n'est pas "topaz8".
  179.  
  180.     -f<fichier> Permet    de  préciser  le  fichier  de  documentation   à
  181.         utiliser. Si vous n'indiquez pas de chemin  d'accès,  le
  182.         fichier doit se trouver dans le  répertoire  courant  ou
  183.         dans le répertoire "ADOC:".
  184.  
  185.     -l        Permet de travailler en mode entrelacé. Si on  n'indique
  186.         pas l'option -e et que l'écran WorkBench  n'est  pas  en
  187.         mode entrelacé, ADoc ouvre son propre écran.
  188.  
  189.     -n        Demande à ADoc de  ne  pas  trier  l'index  lors  de  la
  190.         requête de terme. Cette option doit être indiquée  avant
  191.         une éventuelle option -f.
  192.  
  193.     -q        Empèche l'affichage  du  texte  correspondant  au  terme
  194.         "AboutThisDoc" lors du démarrage.
  195.  
  196.     -A        Met ADoc en mode AREXX (voir §4.6). Les options -i et -e
  197.         ne peuvent être utilisées en même temps que cette option
  198.  
  199.     Dans la seconde forme on peut  indiquer  le  terme  sur  lequel  on
  200. désire voir la documentation, mais ce n'est pas obligatoire.
  201.  
  202.  
  203.     3.2 Appel depuis le WorkBench
  204.     -----------------------------
  205.  
  206.     Depuis le WorkBench, on peut appeler ADoc de quatre façons :
  207.  
  208.     - en double-cliquant sur l'icône d'ADoc (on utilise alors  le
  209.       fichier de documentation par défaut)
  210.     - en double-cliquant sur l'icône  d'un  fichier  qui  a  ADoc
  211.       comme outil par défaut ("Default tool")
  212.     - en cliquant sur l'icône d'ADoc puis en double-cliquant  sur
  213.       l'icône d'un fichier de documentation, le tout  en  gardant
  214.       la touche SHIFT appuyée
  215.     - en cliquant sur l'icône d'un fichier de documentation  puis
  216.       en double-cliquant sur l'icône d'ADoc, le tout  en  gardant
  217.       la touche SHIFT appuyée
  218.  
  219.     Quand ADoc est utilisé à partir du WorkBench, il ouvre toujours son
  220. propre écran. Il est possible d'indiquer des options, dans le  champ  "TOOL
  221. TYPES" de l'icône d'ADoc ou de l'icône d'un fichier  de  documentation.  La
  222. syntaxe est la suivante :
  223.  
  224.            ADOC=[INTERLACE]|[NOSORT]|[CASE]|[QUICK]
  225.  
  226.     Le paramêtre INTERLACE indique à ADoc qu'il doit ouvrir un écran en
  227. mode entrelacé, le paramêtre NOSORT demande de ne pas trier l'index lors de
  228. la requête de terme, et le paramêtre CASE demande de  ne  pas  différencier
  229. minuscules et majuscules (aussi  bien  pour  les  recherches  que  pour  la
  230. requête  de  terme).  Le  paramêtre  QUICK  empèche  l'affichage  du  texte
  231. correspondant au terme "AboutThisDoc" lors du démarrage.
  232.  
  233.  
  234.     3.3 Mode d'emploi
  235.     -----------------
  236.  
  237.     Lors de l'ouverture du fichier d'aide, ADoc cherche automatiquement
  238. le terme "AboutThisDoc". Si ce terme existe,  le  texte  correspondant  est
  239. affiché dans une fenêtre, et ADoc attend que  vous  fermiez  cette  fenêtre
  240. pour continuer.
  241.  
  242.     Si vous appelez ADoc depuis le WorkBench, ou  depuis  le  CLI  mais
  243. sans indiquer le terme à chercher, une boite de requête apparait,  avec  la
  244. liste des termes connus (voir §3.4 pour l'utilisation de cette requête).
  245.  
  246.     Dès que vous indiqué un terme à  chercher,  une  fenêtre  apparait,
  247. avec le texte d'explication correspondant. Si ce texte est trop  long  pour
  248. tenir dans la fenêtre, la première  page  est  affichée,  et  deux  gadgets
  249. (flèche vers le haut et flèche vers le bas) apparaissent sur  la  barre  de
  250. titre de la fenêtre. Ces gadgets vous permettent de faire défiler le  texte
  251. dans la fenêtre, page par page. Pour fermer  la  fenêtre,  cliquez  sur  le
  252. gadget de fermeture, ou appuyez sur la touche ESCAPE.
  253.  
  254.     Vous pouvez cliquer deux fois sur un mot du texte d'explication, ce
  255. qui lancera automatiquement la recherche de ce terme. Si le terme n'est pas
  256. trouvé l'écran flashe, sinon le texte correspondant est  affiché  dans  une
  257. nouvelle fenêtre placée au premier plan.
  258.     Si vous désirez voir le texte associé à  un  terme  qui  n'apparait
  259. dans aucun des textes d'explication déjà affichés, vous devez  utiliser  la
  260. commande "Autre terme" du menu "Projet" : une boite  de  requête  apparait,
  261. avec la liste des termes connus (voir  §3.4  pour  l'utilisation  de  cette
  262. requête).
  263.     Dans les deux cas, si vous sélectionnez un terme  pour    lequel    une
  264. fenêtre est encore présente, cette fenêtre sera simplement mise au  premier
  265. plan.
  266.  
  267.     Vous pouvez imprimer le texte correspondant à un terme en  appelant
  268. la commande "Imprime" du menu  "Projet".  Les  éventuelles  séquences  ANSI
  269. présentes dans le texte seront correctement interprétées par l'imprimante.
  270.  
  271.     Vous pouvez iconifier ADoc, à l'aide de la commande  "Iconifie"  du
  272. menu "Projet". Toutes les fenêtres sont alors  fermées  (l'écran  aussi  si
  273. ADoc avait ouvert son propre écran) et une petite fenêtre apparait dans  le
  274. coin supérieur gauche de l'écran WorkBench. Vous pouvez alors quitter  ADoc
  275. en cliquant sur le gadget de fermeture de cette fenêtre,  ou  le  réveiller
  276. en appuyant sur le bouton droit de la souris. ADoc vous  propose  alors  de
  277. ré-ouvrir toutes les fenêtres qui étaient ouvertes lors de  l'iconification
  278. Si vous répondez "NON", la boite de requête contenant la liste  des  termes
  279. connus s'affiche.
  280.  
  281.     Vous pouvez changer ADoc d'écran, à l'aide de  la  commande  "Ecran
  282. avant" du menu "Projet". Il vous suffit de mettre l'écran sur  lequel  vous
  283. voulez placer ADoc au premier plan, de le faire glisser vers le bas, et  de
  284. placer l'écran où est ADoc juste derrière. Activez alors la commande "Ecran
  285. avant", et toutes les fenêtres ouvertes seront  déplacées  sur  l'écran  au
  286. premier plan. Notez que cette commande ne marchera pas    si  la    police    par
  287. défaut de l'écran cible n'est pas "topaz8", ou si  l'écran  d'ADoc  est  en
  288. mode entrelacé alors que l'écran cible ne l'est pas.
  289.  
  290.     Pour quitter ADoc, vous pouvez soit fermer toutes les fenêtres    une
  291. par une (NOTE : ADoc s'arrête automatiquement quand la dernière fenêtre est
  292. fermée), soit utiliser la commande "Quitte" du menu "Projet".
  293.  
  294.     Lorsqu'une requête OUI/NON est affichée, vous pouvez appuyez sur la
  295. touche RETURN pour répondre "oui", ou sur la touche  ESCAPE  pour  répondre
  296. "non".
  297.  
  298.     3.4 La requête de terme :
  299.     -------------------------
  300.  
  301.     La requête de terme vous permet de choisir un terme  à    la  souris.
  302. Cliquez une première fois sur le terme sur lequel vous voulez de  l'aide  :
  303. ce terme s'affiche en rouge. Cliquez une deuxième fois sur  le  terme  pour
  304. confirmer votre choix, ou sur un autre terme si vous avez changé d'avis.
  305.  
  306.     Vous pouvez utiliser le clavier pour faire votre sélection. Si vous
  307. tapez sur une lettre quelconque,  cette  lettre  sera  ajoutée    au  préfixe
  308. courant (affiché dans le rectangle en bas de la fenêtre), et l'affichage de
  309. la liste des termes se fera à partir du premier  terme    commençant  par  ce
  310. préfixe. ADoc complètera automatiquement le préfixe le    plus  possible.  Si
  311. vous appuyez sur BACKSPACE, la dernière lettre du préfixe sera supprimée et
  312. l'affichage de la liste mis à jour. Si vous appuyez sur RETURN, le  premier
  313. terme correspondant au préfixe sera pris comme terme à    afficher.  Si  vous
  314. appuyez sur ESCAPE, la requête de terme sera fermée.
  315.  
  316.  
  317. 4.Concepts avancés :
  318. --------------------
  319.  
  320.  
  321.     4.1 Utilisation de plusieurs fichiers de documentation :
  322.     --------------------------------------------------------
  323.  
  324.     Il suffit pour cela de préciser le nom des fichiers à utiliser lors
  325. de l'appel du programme : depuis  le  WorkBench, sélectionnez les icônes de
  326. ces fichiers, et depuis le CLI tapez une ligne de commande de la forme :
  327.  
  328.          ADoc [autres options] -fnom1,nom2,...nomn [<terme>]
  329.  
  330.     Vous pouvez indiquez plusieurs options -f, et intercaler les autres
  331. options. Par exemple :
  332.  
  333.         ADoc -fnom1,nom2 -c fnom3 -n -fnom4
  334.  
  335. provoquera le chargement des fichiers nom1, nom2, nom3 et nom4.  Les  index
  336. des fichiers nom1, nom2 et nom3 seront triés dans la requête de terme (sans
  337. différencier minuscules et majuscules pour  le    fichier  nom3),  alors    que
  338. l'index du fichier nom4 ne sera pas trié.
  339.     Si vous ne donnez pas de chemin d'accès, les fichiers doivent  être
  340. dans le répertoire courant, ou dans le répertoire "ADOC:". Si vous indiquez
  341. un nom de répertoire (ou, depuis le WorkBench,  sélectionnez  l'icône  d'un
  342. répertoire) tous les fichiers de ce répertoire (sauf ceux dont  le  nom  se
  343. se termine par ".info" ou par ".index") seront utilisés. Comme dans le  cas
  344. normal, si un ou plusieurs  fichiers  d'index  n'existent  pas,  ADoc  vous
  345. proposera de les créer.
  346.  
  347.     Le fonctionnement d'ADoc est  presque le même qu'avant.  Voici  les
  348. possibilités supplémentaires :
  349.  
  350.     - lors de l'ouverture de  CHAQUE  fichier,  ADoc  cherche  le
  351.       terme "AboutThisDoc" et  affiche  le  texte  correspondant,
  352.       puis attend que la fenêtre soit fermée pour continuer.
  353.     - ADoc cherche le terme désigné à la  souris  dans  TOUS  les
  354.       fichiers de documentation utilisés
  355.     - Si un terme est défini dans plusieurs fichiers, toutes  les
  356.       lignes d'explication seront mises à la suite  et  affichées
  357.       dans une seule fenêtre
  358.     - Lorsque la requête de terme est affichée, l'appui du bouton
  359.       droit de la souris permet de changer la  "page"  affichée :
  360.       on obtient alternativement la liste des termes  du  fichier
  361.       de documentation courant et la liste des fichiers utilisés.
  362.       On peut de la sorte choisir un terme dans n'importe  lequel
  363.       des fichiers de documentation.
  364.  
  365.     ADoc ne chargera pas deux fois un même fichier. Deux fichiers  sont
  366. considérés comme identiques s'ils ont le même nom, OU si  leurs  index  ont
  367. été générés à la même date et heure. Cette date est stockée dans le fichier
  368. d'index lors de sa création, et  ne  changera  donc  que  si  vous  recréez
  369. cet index.
  370.  
  371.  
  372.     4.2 Association de fichiers :
  373.     -----------------------------
  374.  
  375.     Il  est  également  possible  d'associer  automatiquement   un   ou
  376. plusieurs fichiers à un fichier de documentation. Dans ce cas, lorsque ADoc
  377. ouvrira ce fichier,  il  chargera  automatiquement  le    (ou  les)  fichiers
  378. associés.
  379.     Pour utiliser cette fonction, il suffit de mettre la liste des noms
  380. des fichiers à associer (séparés par des virgules) sur la première ligne du
  381. fichier de documentation principal. Si cette ligne reste vide, commence par
  382. un espace ou par une tabulation, aucun fichier n'est associé.
  383.     Sauf si vous indiquez un chemin d'accès, les fichiers associés sont
  384. cherchés dans le répertoire du fichier principal, puis dans  le  répertoire
  385. ADOC:. Si vous indiquez un nom de  répertoire,    tous  les  fichiers  de  ce
  386. répertoire (sauf ceux dont le nom se termine par ".info" ou  par  ".index")
  387. seront associés.
  388.  
  389.  
  390.     4.3 Génération de plusieurs index :
  391.     -----------------------------------
  392.  
  393.     Il est possible d'indiquer plusieurs  fichiers  même  lorsque  l'on
  394. utilise l'option -i, c'est-à-dire que la ligne de commande peut être :
  395.  
  396.             ADoc -i -fnom1,nom2,...nomn
  397.  
  398.     Dans ce cas, les index des tous les fichiers indiqués  sont  créés,
  399. puis ADoc s'arrête.
  400.  
  401.  
  402.     4.4 Extension du jeu de caractères :
  403.     ------------------------------------
  404.  
  405.     Dans certains cas, il peut être nécessaire  d'étendre  le  jeu  des
  406. caractères pouvant être utilisés dans la désignation d'un terme. La seconde
  407. ligne des fichiers de documentation est réservée à cet effet : si  elle  ne
  408. commence ni par un espace, ni par une tabulation, tous les caractères de la
  409. ligne sont ajoutés aux caractères autorisés, jusqu'à ce que ADoc  rencontre
  410. un des caractères suivants : espace, retour, tabulation, saut de  page,  ou
  411. barre de fraction.
  412.     Notez que cette extension est faite fichier par  fichier,  c'est-à-
  413. dire que si que  si  vous  utilisez  simultanément  plusieurs  fichiers  de
  414. documentation, les caractères autorisés changeront d'un fichier à  l'autre,
  415. en fonction de ce que vous avez indiqué sur  la  seconde  ligne  de  chaque
  416. fichier.
  417.  
  418.  
  419.     4.5 Utilisation de la bibliothèque "powerpacker.library" :
  420.     ----------------------------------------------------------
  421.  
  422.     ADoc  est  capable  de    charger  des  fichiers    compactés  par    les
  423. logiciel "PowerPacker 2.3b" ou par "PowerPacker Pro  3.0b", à condition que
  424. vous ayez placé la bibliothèque "powerpacker.library"  dans  le  répertoire
  425. LIBS: de votre disque dur ou de votre disquette WorkBench.
  426.  
  427.     Il n'est pas nécessaire de créer l'index avant le compactage,  mais
  428. cela est recommandé. ADoc refusera de charger un fichier crypté.
  429.  
  430.     Après  décompactage,  le  fichier  sera  recopié  dans    un  fichier
  431. temporaire placé dans le répertoire T:. Ce fichier temporaire sera  détruit
  432. en fin d'exécution. L'utilisation de fichiers compactés peut donc  s'avérer
  433. gourmande en mémoire (surtout si le répertoire T: est sur le disque  RAM:).
  434. Je vous conseille, quand c'est possible, de  compacter  plusieurs  "petits"
  435. fichiers (30 à 50 Ko) plutôt qu'un seul gros fichier (plus de 100 Ko).
  436.  
  437.  
  438.     4.6 Le mode AREXX :
  439.     -------------------
  440.  
  441.     Si vous indiquez l'option -A lors de l'appel d'ADoc, celui-ci passe
  442. en mode AREXX : un port compatible AREXX nommé "ADoc_rexx" est  ouvert,  et
  443. le programme attend des messages sur ce port.
  444.     ADoc ne pourra fonctionner en  mode  AREXX  s'il  doit  ouvrir  son
  445. propre écran : vous ne pouvez donc utiliser l'option -e en même  temps  que
  446. l'option -A. De plus, si vous lancez ADoc depuis le WorkBench, ou  indiquez
  447. l'option -l alors que l'écran WorkBench n'est pas  en  mode  entrelacé,  le
  448. mode AREXX sera automatiquement désactivé.
  449.  
  450.     Les messages peuvent être :
  451.  
  452.     quit   : ADoc ferme le port AREXX et termine
  453.     wakeup : ADoc lance la requête de terme et revient en mode normal
  454.     ?terme : ADoc cherche le terme indiqué et, s'il le trouve, affiche
  455.          le texte correspondant avant de repasser en mode normal
  456.  
  457.     Tout autre message sera ignoré.
  458.  
  459.     Voici un exemple de programme AREXX, qui demande de l'aide  sur  le
  460. terme "alias", et termine ADoc :
  461.  
  462.     /* Demande de l'aide sur "alias" */
  463.     address "ADoc_rexx"
  464.     "?alias"
  465.     "quit"
  466.  
  467.     Notez les guillemets autour des commandes !
  468.  
  469.     Depuis le mode normal, vous pouvez placer  ADoc  en  mode  AREXX  à
  470. l'aide de la commande "Mode AREXX" du menu "Projet".  Toutes  les  fenêtres
  471. sont alors fermées, et ADoc attend des messages sur son port AREXX.
  472.  
  473.     Si vous avez lancé ADoc en  mode  AREXX,  n'oubliez  pas  que  ADoc
  474. repassera automatiquement dans ce mode    quand  vous  fermerez  la  dernière
  475. fenêtre ouverte. Pour être sûr de quitter ADoc dans tous les cas,  utilisez
  476. la commande "Quitte" du menu "Projet".
  477.  
  478.  
  479.     4.7 Utilisation des fichiers AutoDoc
  480.     ------------------------------------
  481.  
  482.     Cette version d'ADoc est capable de reconnaitre et  d'utiliser  les
  483. fichiers AutoDoc de Commodore. Dans la plupart des cas, aucune modification
  484. de ces fichiers n'est  nécessaire,  mais  il  est  fortement  conseillé  de
  485. vérifier leur format : il doit y avoir au moins  deux  lignes  blanches  au
  486. début, et chaque terme doit commencer en colonne 1.
  487.     Dans certains cas, il manquera les lignes blanches au début, et les
  488. termes seront précédés    par  un  caractère  "saut  de  page"  (CTRL-L).  Le
  489. programme AutoConvert, distribué avec ADoc,  vous  permettra  de  convertir
  490. automatiquement ces fichiers dans le bon format (NOTE: ce programme ne peut
  491. s'utiliser que depuis le CLI). Dans tous les autres  cas,  il  vous  faudra
  492. corriger à la main le ou les fichiers AutoDoc.
  493.     Un test a été effectué sur les 45 fichiers AutoDoc  de    la  version
  494. 2.02 du système : 27 ont été acceptés directement, 11 ont dû être convertis
  495. par le programme AutoConvert, et les 7 derniers ont dû être corrigés  à  la
  496. main.
  497.  
  498.     4.8 Le menu "Spécial" :
  499.     -----------------------
  500.  
  501.     L'item "Info" vous permet de savoir combien de fichiers, de termes,
  502. de fenêtres, et de lignes sont disponible en ce moment.
  503.     L'item "Ouvre fichier" vous permet d'ouvrir  un  fichier  d'aide  à
  504. tout moment (en plus des fichiers déjà  ouvert).  Une  requête  de  fichier
  505. apparait, et vous permet de choisir le fichier à ouvrir. Les fichiers  dont
  506. le nom se termine par ".info" ou ".index" ne sont pas affichés. Cliquez sur
  507. "ANNULER" ou fermez la fenêtre pour annuler l'opération.
  508.     L'item "Ferme fichier" vous permet de fermer un fichier d'aide dont
  509. vous n'avez plus besoin, afin de libérer de la mémoire. ADoc vous demandera
  510. confirmation, mais de toute façon vous pourrez recharger le fichier grâce à
  511. l'item "Ouvre fichier".
  512.     L'item "Ferme fenêtres" vous permet de fermer toutes  les  fenêtres
  513. d'aide ouvertes en ce moment.  ADoc  vous  demandera  confirmation,  et  la
  514. requête de terme apparaitra une fois que toutes  les  fenêtres    auront    été
  515. fermées.
  516.  
  517.  
  518. 5. Messages d'erreur :
  519. ----------------------
  520.  
  521.     Le paragraphe  indiqué    après  le  message  d'erreur  contient  les
  522. explications nécessaires pour résoudre le problème rencontré.
  523.  
  524.     Arguments incorrects (§3.1)
  525.  
  526.         Il y a une erreur dans la ligne de commande.
  527.  
  528.     Impossible d'ouvrir <nom>
  529.  
  530.         La ressource <nom> n'a pas pu être allouée.
  531.         Il peut s'agir d'un fichier de documentation (dans  ce  cas
  532.         vérifiez l'existence du fichier) ou  d'un  fichier  d'index
  533.         (voir §3.1 et §3.3 pour le créer).
  534.  
  535.     Ligne trop longue <ligne> (§2)
  536.  
  537.         La ligne dont  le  début  est  indiqué    fait  plus  de    256
  538.         caractères.
  539.  
  540.     Terme trop long <terme> (§2)
  541.  
  542.         Le terme  dont    le  début  est    indiqué  fait  plus  de  32
  543.         caractères.
  544.  
  545.     Pas de texte pour <terme> (§2)
  546.  
  547.         Il n'y a pas de lignes d'explication pour le terme indiqué.
  548.  
  549.     Fichier vide <nom>
  550.  
  551.         Le fichier indiqué est vide, ou aucun terme n'a  été  trouvé
  552.         dans le fichier.
  553.  
  554.     Erreur de lecture <nom>
  555.  
  556.         Erreur lors d'une lecture du fichier indiqué.
  557.  
  558.     Erreur d'écriture <nom>
  559.  
  560.         Erreur lors d'une écriture dans le fichier indiqué.
  561.  
  562.     Fichier d'index incorrect <nom> (§2, §3.1, §3.3)
  563.  
  564.         Le fichier d'index indiqué est  incorrect.  Vous  devez  le
  565.         recréer.
  566.  
  567.     Association incorrecte pour <nom> (§4.2)
  568.  
  569.         La première ligne du fichier indiqué, qui  donne  la  liste
  570.         des fichiers associés, est incorrecte (mal écrite).
  571.  
  572.     Fichier crypté <nom> (§4.5)
  573.  
  574.         Le fichier indiqué a été crypté par PowerPacker.
  575.  
  576.